home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / alGetLimiting.z / alGetLimiting
Encoding:
Text File  |  1998-10-20  |  6.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg((((3333ddddmmmm))))                                          aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      alGetLimiting, alSetLimiting - request limiting for AL floating-point
  10.      output
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg))))
  16.      iiiinnnntttt aaaallllSSSSeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg,,,, iiiinnnntttt vvvvaaaalllluuuueeee))))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  19.      _c_o_n_f_i_g  expects an AAAALLLLccccoooonnnnffffiiiigggg structure, the returned value of a call to
  20.              aaaallllNNNNeeeewwwwCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))) or aaaallllGGGGeeeettttCCCCoooonnnnffffiiiigggg((((3333ddddmmmm)))).
  21.  
  22.      _v_a_l_u_e   expects a boolean value (0 or 1) indicating whether or not
  23.              limiting is required on floating-point to integer data conversion
  24.              for aaaallllWWWWrrrriiiitttteeeeFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))) or aaaallllWWWWrrrriiiitttteeeeBBBBuuuuffffffffeeeerrrrssss((((3333ddddmmmm)))).
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      aaaallllSSSSeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg indicates whether or not an application requires limiting
  28.      when the AL converts floating-point data to integer on output. This value
  29.      potentially affects the behavior of both aaaallllWWWWrrrriiiitttteeeeFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))) and
  30.      aaaallllWWWWrrrriiiitttteeeeBBBBuuuuffffffffeeeerrrrssss((((3333ddddmmmm)))).
  31.  
  32.      If limiting is on, the AL will always limit floating-point output data to
  33.      the limits specified by aaaallllSSSSeeeettttFFFFllllooooaaaattttMMMMaaaaxxxx((((3333ddddmmmm)))).  If limiting is off, the AL
  34.      is free to choose whether or not it performs limiting. In some cases,
  35.      turning limiting off may increase performance, particularly in
  36.      applications producing many output channels of audio.
  37.  
  38.      aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg returns the current value of the limiting hint, either 0 or
  39.      1.
  40.  
  41. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  42.      Upon successful completion, aaaallllSSSSeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg returns 0. Otherwise,
  43.      aaaallllSSSSeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg returns -1 and sets an error number which can be retrieved
  44.      with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  45.  
  46.      aaaallllSSSSeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg can fail for the following reasons:
  47.  
  48.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG     _c_o_n_f_i_g is invalid or null.
  49.  
  50.      aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg returns -1 in the case of failure and sets an error number
  51.      which can be retrieved with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))). When successful, aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg
  52.      returns the current value of the limiting hint in _c_o_n_f_i_g.
  53.  
  54.      aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg can fail for the following reason:
  55.  
  56.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG   _c_o_n_f_i_g is invalid or null.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg((((3333ddddmmmm))))                                          aaaallllGGGGeeeettttLLLLiiiimmmmiiiittttiiiinnnngggg((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEE
  75.      These functions were introduced via patch to IRIX 6.3 and 6.4, and are
  76.      present by default in later OS releases.  You should ensure that the
  77.      target system will have the functionality before calling these functions;
  78.      otherwise, your program will crash when you attempt to make the function
  79.      call. To determine if the feature is present, check the value of
  80.      AL_VERSION on the system resource. The parameter must be present and its
  81.      value must be at least 6.
  82.  
  83.                pv.param = AL_VERSION;
  84.                alGetParams(AL_SYSTEM,&pv,1);
  85.                if (pv.sizeOut < 0 || pv.value.i < 6) {
  86.                    /* feature not present */
  87.                }
  88.  
  89.  
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      alNewConfig(3dm), alGetConfig(3dm), alOpenPort(3dm), alSetConfig(3dm),
  93.      alSetSampFmt(3dm), oserror(3C), alWriteFrames(3dm), alWriteBuffers(3dm)
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.